home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / dat13c.zip / DAT.DOC < prev    next >
Text File  |  1994-03-08  |  6KB  |  183 lines
  1.  
  2.  
  3.                                   DAT, v1.3
  4.                                 -------------
  5.                                 from TifaWARE
  6.  
  7.  
  8.  
  9.  
  10. What's New
  11. ----------
  12.  
  13.  
  14.      With version 1.3 I have substantially reorganized DAT's source code,
  15. placing commonly-used procedures, equates, and macros in separate files.
  16. Sharing code in this way will make it my programming task easier. From the
  17. user's point of view, however, there should be no change. 
  18.  
  19.      Many of the principal functions in DAT have been completely rewritten
  20. for version 1.2. 
  21.  
  22.      New to version 1.1 is the '-n' option, used to suppress display of
  23. the final newline sequence. It will come in handy if you wish to mix
  24. output from both DAT and some other program.
  25.  
  26.  
  27.  
  28.  
  29. Introduction
  30. ------------
  31.  
  32.  
  33.      Ever wish you could keep track of program usage? Ever want to display
  34. the current date and time without having to hit <Enter>? Ever hope for
  35. something better than "ECHO.|DATE" and "ECHO.|TIME", something that would
  36. give you more control over the output format? If so, then DAT is the
  37. answer for you.
  38.  
  39.      DAT is a simple utility to display the current date and time
  40. preceeded by an optional message. Its output can be redirected to a file
  41. thereby enabling you to track easily program and system usage.
  42.  
  43.  
  44.  
  45.  
  46. Usage
  47. -----
  48.  
  49.  
  50.      Running this program is a breeze. Once you've placed DAT.COM  where
  51. DOS can find it, type DAT -? to display a brief help message similar to
  52. the following:
  53.  
  54.      TifaWARE DAT, v1.3a, 08/28/90 - displays the current date and time.
  55.      Usage: dat [-options] [msg]
  56.      
  57.      Options:
  58.        -d = display date
  59.        -n = suppress final newline sequence
  60.        -t = display time
  61.        -? = display this help message
  62.      
  63.      msg is an optional message to display before the date or time.
  64.  
  65. [If you don't remember anything else, at least remember how to display
  66. this help message.]
  67.  
  68.      To see the current date and time invoke DAT with the '-d' and '-t'
  69. options. DAT displays any specified message text, the date and time as
  70. requested, and then terminates output with a newline (CR/LF). For example,
  71. "DAT -t The time is now" generates the message "The time is now  19:00".
  72. As special cases, "DAT" is equivalent to "DAT -dt", while "DAT some
  73. message text" displays only "some message text".
  74.  
  75.      If you're mixing DAT's output with that of another program and need to
  76. skip the final CR/LF combination, use the '-n' option.
  77.  
  78.      You can redirect DAT's output to a file, printer, or even another
  79. program using DOS' redirection characters '>', '>>', and '|'. For example,
  80. you could log usage of Quattro Pro with the following batch file:
  81.  
  82.                echo off
  83.                DAT -dt QPro started: >> QPro.Log
  84.                Q
  85.                DAT -dt QPro ended:   >> QPro.Log
  86.  
  87. Notice that you should use '>>' rather than '>' unless you don't mind
  88. overwriting whatever might already be in QPro.Log.
  89.  
  90.  
  91.  
  92.  
  93. If You Have Any Trouble
  94. -----------------------
  95.  
  96.  
  97.      DAT will let you know of any problems that arise. Here is the only
  98. error message you might see and how you should deal with it:
  99.  
  100.      dat: illegal option -- x.
  101.           - Type "DAT -?" for a list of valid options.
  102.  
  103.  
  104. This message appears on the standard error device. In this way, it won't
  105. disappear down a pipe or into a file should you redirect DAT's output.
  106.  
  107.      Additionally, DAT uses a return code to convey information about the
  108. success or failure of its operation. Possible return values are:
  109.  
  110.      Code      Meaning
  111.      ----      -------
  112.      0         Program completed successfully
  113.      1         Help message was displayed
  114.  
  115. You can test for these codes using the ERRORLEVEL variable in a batch file. 
  116.  
  117.  
  118.  
  119.  
  120. Requirements
  121. ------------
  122.  
  123.  
  124.      TifaWARE DAT runs on machines operating under DOS v2.xx or later, and
  125. requires practically no memory. It does not use BIOS calls, make direct
  126. writes to video RAM, or otherwise require machines to be "PC-compatible".
  127. In fact, DAT even runs properly on a DEC Rainbow!
  128.  
  129.  
  130.  
  131.  
  132. Who Owns It?
  133. ---------------
  134.  
  135.  
  136.      I am releasing this program into the public domain. Since 1984 I have
  137. used public-domain software extensively, and I find it to be a terrific
  138. idea. Most programs are useful, and the source instructive. And they cost
  139. nothing! With this small contribution to the public domain I hope to pay
  140. back my gratitude to those other programmers who have made my computing so
  141. much easier.
  142.  
  143.      However, this program carries no obligation on my part to support
  144. users or provide future upgrades. I try to write clean code and believe it
  145. is "bug-free". Nevertheless, use this program ***AT YOUR OWN RISK***. Scan
  146. the source yourself, make any desired changes, and recompile the program,
  147. if possible. Make this standard practice with newly-acquired software and
  148. you'll not only protect your system from viruses but also get a better
  149. feel for exactly how programs work!
  150.  
  151.      As author of this program, I have two requests: First, please keep
  152. together the original source code, documentation, and executable if you
  153. distribute the package. This just makes it easier for others to use the
  154. software. Second, let me hear what you think of it - I'd appreciate a
  155. postcard with your comments. Enjoy!
  156.  
  157.  
  158.  
  159.  
  160. Kudos
  161. -----
  162.  
  163.  
  164.      Thanks to Ron Brandt of SATALINK BBS who inspired me to develop this
  165. program. Ron runs a fantastic bulletin board; call it at +1 215 443-9434.
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.                           George A. Theall
  173.  
  174.                              TifaWARE
  175.                          610 South 48th St
  176.                       Philadelphia, PA.  19143
  177.                               U.S.A.
  178.  
  179.                          george@tifaware.com
  180.                         theall@popmail.tju.edu
  181.                      theall@mcneil.sas.upenn.edu
  182.                      george.theall@satalink.com
  183.